Setup & Installation Guide
Windows & macOS

Everything you need to download, install and run ShowPrompt — from a fresh laptop to a live dashboard in about ten minutes. Follow it once; after that, starting ShowPrompt takes seconds.

Windows 10 / 11 macOS ~10 min first-time setup Runs offline during shows No accounts
This document is the practical setup guide. If you want an overview of what ShowPrompt does — the six production modes, full feature list and pricing — see the guide on the website: showprompt.net/guide. This page is purely about getting it installed and running.
Contents Before you start 1 · Install Node.js 2 · Get the folder ready 3 · Start ShowPrompt 4 · Open the dashboard 5 · Activate licence 6 · Connect displays Stream Deck & Companion Troubleshooting
Before you start

What you need

The short version: install Node.js once → double-click Start ShowPrompt in the folder → your browser opens at the dashboard. Everything below is that, with a little more detail on each step.
1

Install Node.js (one-time)

ShowPrompt runs on Node.js, a free, standard piece of software. You only install it once per computer. Go to nodejs.org and download the LTS version (the recommended one on the left).

🪟 Windows

  1. Download and run the .msi installer.
  2. Click through the defaults. Leave “Add to PATH” ticked (it is on by default) — this lets ShowPrompt find Node.
  3. Finish, then continue below.

macOS

  1. Download and run the .pkg installer.
  2. Click through the defaults and enter your password if asked.
  3. Finish, then continue below.

That's all you need to do by hand. You don't have to check anything — when you start ShowPrompt in the next steps, its launcher detects Node.js automatically and will tell you if it isn't found.

2

Get the ShowPrompt folder ready

Unzip your download and put the ShowPrompt folder somewhere easy to find — your Desktop or Documents is ideal. Don’t run it from inside the zip.

🪟 Windows

Right-click the downloaded .zipExtract All… → choose Desktop or Documents → Extract.

macOS

Double-click the downloaded .zip. The ShowPrompt folder appears next to it — drag it to your Desktop or Documents.

✓ You should now have a folder named ShowPrompt containing server.js, package.json, a public folder, and the launcher files.
3

Start ShowPrompt

This is the easy part. Just double-click the Start ShowPrompt launcher in the folder — it installs what it needs on the first run, then starts the server and opens your browser automatically. No terminal, no commands.

🪟 Windows

Double-click Start ShowPrompt.bat in the folder.

The first run installs dependencies (this needs internet and takes a minute); after that it’s instant.

If Windows shows a blue “Windows protected your PC” box: click More info → Run anyway. This is normal for a new app and only happens once.

macOS

Double-click Start ShowPrompt.command in the folder.

The first run installs dependencies (needs internet, takes a minute); after that it’s instant.

If macOS blocks it with a box titled “Start ShowPrompt.command Not Opened”: click Done (never “Move to Bin”), then open System Settings → Privacy & Security, scroll down to the Security section and click Open Anyway; confirm with your password or Touch ID. Only needed the first time. (Older macOS: right-click the file → Open → Open.)

“Start ShowPrompt.command” Not Opened Apple could not verify it is free of malware. This is normal — ShowPrompt is safe. DoneMove to Bin
Click Done — never “Move to Bin”. Then System Settings → Privacy & Security → Open Anyway.
Keep the little status window open while you use ShowPrompt — that window is the server. Closing it stops ShowPrompt. It shows the dashboard address and your network IP for connecting other screens.
4

Open the dashboard

Start ShowPrompt opens it for you automatically. If you want to open it again in any browser, go to:

http://localhost:3000

This is the ShowPrompt dashboard — your home base for opening any mode, the settings, and the displays.

✓ If the dashboard loads, your server is running correctly.
5

Activate your licence (Pro / Venue only)

ShowPrompt runs on the Free tier straight away with no key needed — skip this step if Free covers what you need. Pro and Venue are unlocked with the licence key from your order or trial confirmation email.

  1. Open http://localhost:3000 and click Settings (top-right of the dashboard).
  2. Find the Licence section.
  3. Paste your key into the box and press Activate.

The key is checked once online, then the tier badge updates across every page. Activate the same key on each machine you want to license. Once activated, ShowPrompt stays unlocked offline — it only needs to reach the internet again periodically to re-confirm the licence.

Trial / promo codes apply at checkout on the website, not in the app. After checkout you’ll receive a licence key — that key is what you paste into Settings here.
6

Connect your displays

A controller is the operator’s page; a display is the screen your talent or crew watches. You can run everything from one laptop, or spread displays across the network.

Single machine (simplest)

In any controller, click 📺 Open Display — it opens the display in a separate window. Drag that window onto your second monitor and press F for fullscreen. Feed that monitor into your screen or vision-mixer chain as normal. Total kit: one laptop and one video cable.

Over the network

On any other device on the same network — iPad, phone, smart TV, kiosk, another laptop — open a browser and go to the address shown in the ShowPrompt status window:

http://[YOUR-IP]:3000

No software to install on those devices — any browser works. Choose the display you need from the page.

✓ The controller header shows a live count of connected displays, and each display’s top bar turns green when it’s linked.
For best reliability: run the server on a dedicated laptop (plugged in, sleep disabled), use a wired network where you can, and test every display about 30 minutes before doors.
Optional

Stream Deck & Bitfocus Companion

ShowPrompt ships with a Companion module so a Stream Deck (or any Companion surface) can drive timers, cues, recovery actions and more, with live button labels. The module folder is included in your download as companion-module-showprompt.

  1. Quit Companion.
  2. Open your Companion modules folder:

🪟 Windows

%APPDATA%\Bitfocus Companion\modules-dev\

macOS

~/Library/Application Support/Bitfocus Companion/modules-dev/

  1. Copy the companion-module-showprompt folder into modules-dev.
  2. Open a terminal inside that copied folder and run npm install.
  3. Start Companion, add a new instance, choose ShowPrompt, and set the host to your ShowPrompt machine and port 3000.
Once placed in modules-dev, Companion auto-loads the module on startup. Then open Companion’s Presets tab and drag in the ready-made Stage Manager or Recovery button sets.
?

Troubleshooting

?

The first run didn’t finish setting up

The first time you start ShowPrompt it needs an internet connection for about a minute to set itself up. If that was interrupted, close the status window, check you’re online, and double-click Start ShowPrompt again — it will finish and then open as normal.

?

It says Node.js isn’t installed

If Start ShowPrompt reports that Node.js can’t be found, install it from nodejs.org (the LTS version); on Windows make sure “Add to PATH” stays ticked during installation. Then close the status window and double-click Start ShowPrompt again.

?

The launcher won’t open / the security warning blocks it

Windows: on the blue “Windows protected your PC” box, click More info → Run anyway. Mac: you'll see “Start ShowPrompt.command Not Opened” — click Done (not “Move to Bin”), then open System Settings → Privacy & Security, scroll down and click Open Anyway, and confirm. (Older macOS: right-click Start ShowPrompt.command → Open → Open.) This only happens the first time.

?

“Port in use” / something else is on 3000

Most often this is a previous ShowPrompt session still running. Close any other ShowPrompt status windows, wait a few seconds, then double-click Start ShowPrompt again. If something else on the computer is using port 3000, close that program first.

?

A display won’t load on another device

Check both devices are on the same network, and that the IP matches the one in the ShowPrompt status window. Make sure that window is still open and running. If the venue network is unreliable, use the single-machine method — server and display on one laptop, output over a video cable.

?

A page shows “Disconnected” or “Reconnecting…”

Confirm the ShowPrompt status window is still open and running. Displays reconnect on their own within a few seconds — no refresh needed. For a controller, a page refresh reconnects immediately.

?

The network changed and it stopped working

Close the ShowPrompt status window to stop it, then double-click Start ShowPrompt again. The new IP appears in the window — update the address on any devices connected over the network.

?

A mode looks locked / panels are greyed out

That mode belongs to a higher tier. Free = basic Conference timer and flash. Pro = full Conference, Broadcast and Talent. Venue = adds Matchday, Worship and Theatre, plus unlimited displays. Activate a Pro or Venue key in Settings to unlock the rest.

?

My licence key is rejected

Enter the key exactly as supplied, including any prefix and all dashes. Activation needs internet that one time. If a correct key is still refused, contact support at showprompt.net/support — the key may not match this version.

That’s it — you’re ready to run a show.

For how each mode works and the full feature walkthrough, see the user guide at showprompt.net/guide. Need a hand? showprompt.net/support.